home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / boot-tools / bootselector1.40 / doc / bootselector_engl.doc < prev    next >
Encoding:
Text File  |  1996-03-23  |  15.8 KB  |  377 lines
  1. BootSelector1.40-DOC by Michael Gollmick
  2.  
  3.   --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  --
  4.    ________
  5.   \   ___  \  ° _°_     ____  ____           _______      _______
  6.    \  \  \__\   \  \   / _ / / _ /______    / _____/     /_  _  /___
  7.     \  \     ___ \ \\ /  //_/  //_   __/   / /_________ //  //_//  /__
  8.      \  \ ___\  \ \  X   / _\  / _\  _)_  /____  /  _  X   /_/_   ___/
  9.       \  \\___\  \/  /  /  // /  // /   \ _   / /  (_)  ) ___//  /
  10.        \  \___\\____/  /   / /   /_______\/__/ / \     / /   /  /
  11.         \________\/_______/_____/      /______/   \___/ /   /__/
  12.                                                     /__/   
  13.  
  14.     - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- - --  -- -
  15.  
  16.  
  17.                   presents
  18.  
  19.                   BootSelector 1.24
  20.                   =================
  21.  
  22.              © 1995 by Michael Gollmick
  23.  
  24.     I    Distribution               This is MAILWARE
  25.     II   Warranty                   No warranty!
  26.     III  Requirements               68060, 32MB RAM, Gfx-Board? No!
  27.     IV   Introduction               Something about the program
  28.     V    Usage and Installation     How to use a program
  29.     VI   BUGS                       No BUGS in this version, sorry
  30.     VII  The Future                 What future developing will bring
  31.     VIII Credits                    People who helped me
  32.     IX   History                    The most boring part...
  33.     X    Support                    Hotline for free...
  34.  
  35. Distribution
  36. ------------
  37.  
  38. BootSelector is freely distributable Software. The archive must not be modified
  39. and  must  be  spread as a whole. BBSes may add their sign to the archive. This
  40. program is not Public Domain. It is FREEWARE. Thats why I haven't included  the
  41. sources. This program is also MAILWARE. That means, I expect a mail or a letter
  42. from everyone, who is using it. This mail should contain some information about
  43. the  particular  machine being used and the user. Your information will help me
  44. TO remove BUGs quicker.
  45. Personal information is kept confidential and is only for me.
  46. This archive may be included in every PD-Library, BUT under the  observance  of
  47. the  conditions  named,  and  also  of  mailing or writing to me as the author.
  48. Excluded   from   these   conditions   are   only   the   Aminet-    and    the
  49. Fred-Fish-Collections.  If  you  mail  me  (and  this  is the proper meaning of
  50. MAILWARE), please use the following sheet:
  51.  
  52. -------------------------------------------------------------------------------
  53.  
  54. Name, Firstname:
  55. E-Mail         :
  56. Country, City  :
  57. Computer       :
  58. Kickstart      :
  59. Processor      :
  60. Memory         :
  61. Comment        :
  62.  
  63. -------------------------------------------------------------------------------
  64.  
  65. Warranty
  66. --------
  67.  
  68. There is no warranty implied with this software.  Please read the following:
  69.  
  70. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
  71. LAW.  EXCEPT  WHEN  OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDER AND/OR
  72. OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT  WARRANTY  OF  ANY  KIND,
  73. EITHER  EXPRESSED  OR  IMPLIED,  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  74. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR  A  PARTICULAR  PURPOSE.  THE
  75. ENTIRE  RISK  AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  76. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST  OF  ALL  NECESSARY
  77. SERVICING, REPAIR OR CORRECTION.
  78. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING  WILL
  79. ANY  COPYRIGHT  HOLDER, OR ANY OTHER PARTY WHO MAY REDISTRIBUTE THE PROGRAM
  80. AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,  INCLUDING  ANY  GENERAL,
  81. SPECIAL,  INCIDENTAL  OR  CONSEQUENTIAL  DAMAGES  ARISING OUT OF THE USE OR
  82. INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA  OR
  83. DATA  BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES
  84. OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER  PROGRAMS),  EVEN  IF
  85. SUCH  HOLDER  OR  OTHER  PARTY  HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
  86. DAMAGES.
  87.  
  88. Requirements
  89. ------------
  90.  
  91. I don't know what your local PC-Dealer is recommending (but  most  likely  he's
  92. trying  to  sell  only  overbeared, wrong calculating 5umms or a "really great,
  93. favourable,  powerful"  80268  and  conceals,  that  PC's   where   technically
  94. overhauled already in 1989)
  95. We against recommend FOR this really useful program:
  96.  
  97.  - Amiga 500, 500+, 600, 1000, 1200, 2000, 3000, 4000; DraCo
  98.  - Kickstart 2.0 or higher
  99.  - Harddisk (recommended!)
  100.     because selecting the `Startup-Sequence` in Floppy-Disks-Only-Mode is a
  101.     little bit senseless, nevertheless the program will work.
  102.  - a mouse of course
  103.  - `Execute`-command
  104.  
  105. If you use a higher processor, you can of course choose an optimized version of
  106. BootSelector. For this you have the oportunity of cohoosing between:
  107.     Mototola MC68000
  108.     Motorola MC68020
  109.     Motorola MC68040
  110. If you have anotherone than the listed processors, you should use the nearest
  111. smaller version to your processor. Specialversions like EC or LC are not used
  112. Here a small example:
  113. You have a MC68030:   choose MC68020
  114. You have a MC68LC040: choose MC68040
  115. You have a MC68EC020: choose MC68020
  116.  
  117. Are you familiar with the problem? You invested Money in a better Monitor  (VGA
  118. or  Multi-sync)  and the mode you use is not the 15 Khz default Screenmode? But
  119. when booting, your Amiga is in it's in native Screenmode of 15kHz?  Imaginative
  120. as  we Amiga-purists are, we write some '>NIL:'s to the Startup-Sequence and we
  121. are no longer in the 15kHz-Screen. On  Relais  Monitors  switching  into  other
  122. frequencies  occurs with a loud click when IPrefs is started. The screen is now
  123. opened in its higher frequency and your machine is ready  to  work.  Since  the
  124. Amiga  is  an  open ended machine with unlimited methods of configuration, many
  125. users configure their machines using different script files (as I sometimes  do
  126. myself)  and  execute  these  script  files using a program such as BootManager
  127. (from Daniel Bachmann). And are subject again  to  the  lousy  old  Problem  of
  128. clicking relais. All this 'choosing-programs' has had the same problem: We open
  129. a 15kHz-Screen, choose our script, let click the relais and switch the mode  to
  130. Super-Hires-256 NonInterlace.
  131.  
  132. IF not FOR the lousey 15 Khz DEFAULT screen I would be using BootManager today.
  133. But  of  course  the BootManager is used by me even today, if there wouldn't be
  134. this lousy 15-kHz-Screen! Now ask your physician or druggist and he wouln't  be
  135. able  to  help you, he is already happy, if he is able to run his cash-software
  136. on his PC and in no case he can spent any time in a 'lousy' Amiga (I also think
  137. 99.9%  of  all  physicians  and  druggists  have  no  idea of the Amiga). So we
  138. continue searching some solution.
  139.  
  140. After spending countless hours searching for a program  to  solve  the  15  Khz
  141. dilemma,  I decided to come up with a solution of my own, knowing others in the
  142. Amiga community would benefit from my efforts.
  143.  
  144. After numerous attempts, I had a version which was able to execute a script  if
  145. a  mousebutton was pressed at start up. I decided to expand this feature for my
  146. brand new 3 Button-Mouse. So it was finally possible  to  execute  6  different
  147. scripts  with a 3-Button-Mouse or 3 different scripts with a 2-Button-Mouse. On
  148. my machine, BootSelector is now running with only 3 Startup-Sequences  (because
  149. I don't need more).
  150. It looks as follows:
  151.  
  152. IF you don't press any  mousebutton  at  startup,  the  machine  will  boot  in
  153. ordinary  fashion with no opened screen, AND the standard-Startup-Sequence will
  154. be loaded.
  155.  
  156. IF you press the middle mousebutton, BootManager will be loaded.
  157.  
  158. IF you press the left mousebutton at startup, my favourite game will be loaded.
  159.  
  160. I havn't put a Startup-Sequence onto the other mousebuttons,  because  I  don't
  161. need  more  at  the moment. But the potential is there. You can use the RMB and
  162. combinations of the mousebuttons, for a total of six different  scripts,  since
  163. LMB+RMB  and  LMB+RMB+MMB  are used by systems early startup (Startup-Menu). In
  164. the future there will be a solution for using these combinations too.
  165.  
  166. Introduction
  167. ------------
  168.  
  169. The useage + installation
  170. -------------------------
  171.  
  172. The best way to install this package is to use the  included  Installer-Script.
  173. Please  confirm  (through  the  CBM  version  command)  that  you are using the
  174. Commodore Installer Version 1.24 or higher, since there will  be  some  obvious
  175. malfunctions if you use a lower version.
  176.  
  177. When the Installation is  complete,  you  should  configure  your  existing  or
  178. alternative  scripts  thru  BootSelector.  For  doing  this,  you should do the
  179. following:
  180. - open the Startup-Sequence from S: for editing.
  181. - add a  keyword  after the command BootSelector in  the  first  execution-line
  182.   (e.g.  LMB),  than  a  '=' followed by the name of the alternative script. It
  183.   could look as folows:
  184.   BootSelector LMB=Galaga.STARTUP
  185. - additionally  there  should  be  a  path  FOR  the  alternate  scripts  since
  186.   BootSelector  searches  the  S:  path by default. But if you are working with
  187.   many Startup-Sequences  it  is  recommended  you  put  them  into  their  own
  188.   directory  (as  done by the Installer; e.g. S:Startup's). This information is
  189.   done by the keyword DIR or SCRIPTDIR. It looks as follows:
  190.     BootSelector SCRIPDIR=S:Startup's/
  191.   It is imperative  the  ending  '/'  (backslash)  or  ':'  is  present,  since
  192.   BootSelector  does  not  automatically append it and will fail if this is not
  193.   included.
  194. - At the end the line should look nearly this:
  195.     BootSelector LMB=Alternate.Startup MMB=Galaga.Startup DIR=S:Startup's/
  196.  
  197. - The single Keywords(ToolTypes) may be shown by the command  'BootSelector  ?'
  198.   Here the descriptions:
  199.    REGULAR=REG   IF you press no mousebutton
  200.    LMB           IF you press left mousebutton
  201.    MMB           IF you press middle mousebutton
  202.    RMB           IF you press right mousebutton
  203.    LMM           IF you press left AND middle mousebutton
  204.    RMM           IF you press right AND middle mousebutton
  205.    SCRPTDIR=DIR  Path FOR ALL the Scripts
  206.  
  207. The Installer-Script does copy some alternative scripts to  S:Startup's,  which
  208. have  the  same  names  as the defaults in BootSelector. So you can also rename
  209. your alternative scripts to these names or edit the include scripts. If you  do
  210. this, there is no need to edit the keywords after the command BootSelector.
  211. With the command 'version Startup-SequenceXXX' you can learn  which  script  is
  212. for  which  mousebutton, where XXX stands for the roman numerals after the word
  213. Startup-Sequence.
  214.  
  215. BUGS
  216. ----
  217.  
  218. This program has been tested on my machine most extensively (in  the  long  and
  219. wee hours of the night, nights where I was more nearly to a coffein shock as to
  220. a regular night sleep. In times, where my consume of  coffee  gots  dimensions,
  221. which  where  not payable for me and hearings at University where not main goal
  222. of my life).
  223.  
  224. What I want to say with it: If you find a BUG in this program, Im really sour!
  225.  
  226. But Seriously: As I published this Version,  I  was  at  the  meaning  to  have
  227. reached  a  status  of BUGlessness, which makes it possible to do a publishing.
  228. (But, by the way, I was near a Coma and  a  physical  state  was  near  a  full
  229. seediness and prevented further work on it).
  230.  
  231. About information of mailfunctions I wouldn't be happy, but if they reach me, I
  232. will stop studying, plunder the next hypermarket (need some coffee), and code a
  233. BUGfree version.
  234.  
  235. Your Bugreports reach me via e-mail:
  236.  
  237.            wir94dgk@Rzaix340.rz.uni-leipzig.de
  238.  
  239. or via postal way:
  240.  
  241.            Michael Gollmick
  242.            Löbauer Straße 43
  243.            04347 Leipzig
  244.            Germany
  245.  
  246. Testconfigurations:
  247.  -AMIGA 1200, 2MB CHIP, 8MB FAST, Blizzard 1220 Turboboard, Kickstart 3.0
  248.  -AMIGA 1200, 2MB CHIP, 8MB FAST, Blizzard 1230IV Turbboboard, Kickstart 3.1
  249.  -AMIGA 500+, 2MB CHIP, 2MB 16-BitFAST, Roktek HD-Controller, Kickstart 3.1
  250.  -AMIGA 500, 1MB CHIP, 1.5MB 16-BitFast, 4MB 32-BitFast, Neuroth 68020/882,
  251.   FSE-SCSI-Controller, Kickstart 3.1
  252.  
  253. The future
  254. ----------
  255.  
  256. What I have planed for further version, what might be included...
  257.  
  258.   - a GUI in higher resolutions (I've tried hard, but I couln't realize
  259.     until now)
  260.   - 'remembering' the last called startup-sequence after a reset
  261.     (Idea from Beno Zidariç)
  262.   - the list is a bit longer but I can't and won't realize all the Ideas I
  263.     got (but some new things will come)
  264.  
  265. I`m very thankful for suggestions  concerning  this  program  as  well  as  for
  266. further  projects.  Your  name  will be included in my credit list and you will
  267. recieve a free update (seems to be a little bit strange because this program is
  268. MAILWARE, doesn`t it?).
  269.  
  270. Credits
  271. -------
  272.  
  273. I`m very thankful to:
  274.  
  275.         Michael Reichenbach Oliver Steinhäuser and others
  276.          - for agonizing beta-testing
  277.          - as well as for ideas which are implemented in this
  278.            project or may be included in later versions
  279.  
  280.         Pascal Behrend
  281.          - for reworking the german manual
  282.          - for translating the manual into English (Have you ever read
  283.            my translation? No? - Seems to be the best!)
  284.  
  285.         Ville Ranki
  286.          - for the Finnish Guide
  287.  
  288.         Ron Shaw
  289.          - for spellchecking the english documentation
  290.  
  291.         Commodore
  292.          - for developing the best computer (todate) with a
  293.            tremedous Operating System.
  294.  
  295.             Wouter van Oortmerssen
  296.              - for his genious AmigaE
  297.  
  298.         ...and all who (e)mailed me
  299.  
  300. History
  301. -------
  302.  
  303. The story so far...
  304.  
  305. ... Version 1.01 - INITIAL AMINET RELEASE
  306.     07.08.95     - 
  307.          - removed the ReadTooltype()-BUG from V1.00
  308.          - includet the Version-String for VERSION
  309.          - new Errorhandlingroutine
  310.          - Errorhandlingroutine has been improoved
  311.          - code optimized again (gained 1234 bytes)
  312.          - bug fixed: machine crashed when a wrong directory was set
  313.          - finished Documentation for the Release
  314.  
  315. -----------------> Had a very bad hardcrash on my HD, so I had TO stop the
  316.            developing for a while
  317.          > restarted the developing on 19.08.1995 with an old 80MB HD
  318.  
  319. ... Version 1.10 - OFFICIAL AMINET RELEASE
  320.     30.08.95     - Code has been optimized again (gained 36 Bytes)
  321.          - now up to tree times faster due to the optimization
  322.          - REGULAR Tooltype may be edited short now
  323.          - Errorhandler has been overworked again
  324.          - needs less memory for its work
  325.  
  326. -----------------> Developing stopped for some weeks due to some practical
  327.            work and a fu..ing accident
  328.          > development restarted on 3.10.95
  329.  
  330. ... Version 1.24 - OFFICIAL AMINET RELEASE
  331.     23.10.95     - addet the combination of LMB & MMB
  332.          - REGULAR is no longer a required keyword and has a default
  333.            value now
  334.          - created an Installer-Script (in German an English)
  335.          - addet the Finnish Guide (thanks to Ville Ranki)
  336.          - addet the INFO keyword
  337.          - RMB is now detectable and includet
  338.          - addet a small filecheck
  339.          - optimized the code again due to new functions
  340.          - a red screen will be opened, if required Startup-Sequence
  341.            can't be found
  342.          - overworked the english DOC (thanks to Ron Shaw)
  343.  
  344. ... Version 1.30 - OFFICIAL AMINET RELEASE
  345.     03.11.95     - removed the OpenFile() bug finally (didn't succeed before)
  346.          - the red screen opens now in 320x200pix (for NTSC-users)
  347.          - some code optimisation
  348.          - addet an automatical path-detection
  349.  
  350. ... Version 1.31 - OFFICIAL AMINET RELEASE
  351.          - removed two useles tooltypes, since using them is im-
  352.            possible, cause of the system. If you have read them by
  353.            typing bootselector ?, you may have wondered
  354.          - updated documentation amd Install script
  355.  
  356. ....Version 1.40 - OFFICIAL AMINET RELEASE
  357.     23.03.95     - addet a 020 and 040 Version
  358.          - INFO-Switch has been removed
  359.          - minor other changes in source code
  360.          - main code has been optimized -> gained ca.200 Bytes
  361.          - recompiled in AmigaE V3.2e
  362.          - updated Installer-Script
  363. Hope you can use this program. I would be happy about  any  reactions  to  this
  364. program.  If  you  use  it  or  if you have problems/questions, so feel free to
  365. contact me under:
  366.  
  367.            wir94dgk@rzaix340.rz.uni-leipzig.de
  368.  
  369. I will try to answer your questions within seven days if I can.  (In  the  last
  370. two  month  there where some problems getting acces to the net, so it took much
  371. longer than seven days. I want to excuse me for this in this way.)
  372.  
  373. Michael Gollmick
  374. in March 1996
  375.  
  376. --
  377.